home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / cli / mlinkrep.lha / MakeLink_replacement / MakeLink.doc next >
Encoding:
Text File  |  1994-10-18  |  5.0 KB  |  148 lines
  1.  
  2. *******************************************************************************
  3.  
  4.                            MakeLink Replacement v1.0
  5.                          "Use the power of softlinks!"
  6.  
  7.                          --- Freely Distributable ---
  8.  
  9.                            © 1994 The Beet Research
  10.                          written by Grzegorz Calkowski
  11.  
  12. *******************************************************************************
  13.  
  14.  
  15. DISCLAIMER
  16. ----------
  17.  
  18.     The  program  executable  and  information  above  is provided "as is".  No
  19. representations   or   warranties  are  made  with  respect  to  the  accuracy,
  20. reliability,  performance,  currentness,  or  operation  of  this  software and
  21. information,  and  all  use is at your own risk.  The author doesn't assume any
  22. responsibility  or liability whatsoever with respect to your use of the program
  23. and information.
  24.  
  25.  
  26. COPYRIGHT
  27. ---------
  28.  
  29.    MakeLink  Replacement  is just Freely Distributable.  NOTE, you may not copy
  30. and/or distribute this program without this doc file!
  31.  
  32.  
  33. REQUIREMENTS
  34. ------------
  35.  
  36.     MakeLink  requires  at  least V37 (2.04) Kickstart as in V36 softlinks were
  37. broken.
  38.  
  39.  
  40. DESCRIPTION
  41. -----------
  42.  
  43.     MakeLink  was  developed  as replacement for orginal C='s makelink command.
  44. The  orginal  one lacks of one very useful feature - doesn't support softlinks.
  45. This  is why the replacement was made.  Yes, but what advantage softlinks give?
  46. With  them,  you can make a link ACROSS devices.  For example across partitions
  47. of  your  harddisk  or  even across floppy disk and harddisk partition!  In the
  48. last  case  when you "cd" dir linked to a floppy you will be asked to insert it
  49. if it's not mounted.  Technically it's possible, because softlinks are resolved
  50. at access time while a hardlink is equivalent to the dir/file itself.
  51.  
  52.     As in V37, V39 and V40ß (40.1) (I didn't test it on the latest V40 release)
  53. softlinks  are  NOT  fully supported by OS.  MakeLink supports *ONLY* softlinks
  54. for directories.  To make a link to a file a hard one must be used.  Well, it's
  55. possible  to  make softlink to a file but the link will be created as directory
  56. (!) and, surprise, the file can be accessed by entering such a directory!  It's
  57. not only strange but also has quite important limitations - no arguments can be
  58. parsed  and  even such link cannot be copied!  Only can be executed from Shell.
  59. As  it  is  REALLY  strange  behavior  I  deciced  to not allow it.  Note, even
  60. softlinks are not fully implemented they are _SAFE_ to use.
  61.  
  62.     WARNING!!!
  63.  
  64.     One  word has to be said about hardlinks.  Kickstart file systems versions,
  65.     including  V37,  V39 and V40.1 (ßeta) have a _BUG_ in handling of hardlinks
  66.     which  CAN cause SERIOUS corruption of your harddisk and even system can be
  67.     UNABLE to validate such volume!!!  It can happen when you create a hardlink
  68.     to  a  file  and  remove  this  file  while  the hardlink still exists!
  69.     So generally:  DON'T USE IT :-(.
  70.     
  71.     Note,  that  the  new  MakeLink  is only 52 bytes longer than orginal one!!
  72. (without   additional  comments  it's  even  shorter!   100%  assembly...   :).
  73. MakeLink was tested with Enforcer and no hits were encountered.
  74.  
  75.  
  76. USAGE
  77. -----
  78.  
  79.     Command template: 
  80.  
  81.     FROM/A,TO/A,HARD/S,FORCE/S, where:
  82.  
  83.     FROM        name of the link
  84.     TO        dir/filepath to be linked to
  85.     HARD        if specified hardlinks will be used
  86.             by default soft-links are used
  87.     FORCE        required for directory links
  88.  
  89.     MakeLink  is  supposed  to  be used in nearly exact way as the orginal one.
  90. The  only  difference  is you have to specify HARD if you want to use hardlinks
  91. instead  of  soft  ones.   Note that this switch exists in orginal makelink but
  92. even if not specified hard links are used.  IT'S THE DIFFERENCE.
  93.  
  94.  
  95. EXAMPLARY USAGE
  96. ---------------
  97.  
  98.     makelink a_soft_link MyDir FORCE
  99.  
  100.     Creates a softlink named "a_soft_link" in current directory to
  101.     directory "mydir". Note the FORCE keyword must be specified.
  102.  
  103.     makelink sys:another_soft_link mydisk: FORCE
  104.  
  105.     Creates a softlink in SYS: to volume entitled "mydisk".
  106.  
  107.     makelink floppy df0: FORCE
  108.  
  109.         Creates a softlink to _ANY_ floppy disk inserted in df0:
  110.  
  111.     makelink links_here/a_hard_link :mydir HARD FORCE
  112.  
  113.      Creates a hardlink in dir "links_here" to directory named "mydir"
  114.     placed in the root. Note the FORCE keyword must be specified.
  115.  
  116.     makelink a_file_link tools/myfile HARD
  117.  
  118.     Creates a hardlink to file "tools/myfile".  Note the file and the link
  119.     _MUST_ exists on the same volume just due to nature of hardlinks.
  120.         See warning above.
  121.  
  122.  
  123. NOTE
  124. ----
  125.  
  126.     I'm  sure  there  are other makelink replacements which supports softlinks.
  127. As  I  haven't any I decided to code my own.  (I live in small village and as I
  128. haven't direct access to Internet or any BSS I do not so often get hot stuff...
  129. I have to rely on slooow snail-mail chanells... how sad...8·|. )
  130.  
  131.  
  132. CONTACTING THE AUTHOR
  133. ---------------------
  134.  
  135.     Any ideas or bug reports will be sincerely welcomed.  Just drop me a piece
  136. of paper.
  137.  
  138.  
  139.         Grzegorz Calkowski
  140.         Rzedowice
  141.         ul.Dobrodzienska 8
  142.         42-780 Dobrodzien
  143.         POLAND
  144.         
  145.         (snail-mail rules...ahem..suxx!)
  146.  
  147.  
  148.